menubar

Type

property

Summary

Specifies the name of a menu bar to use when a stack is frontmost.

Syntax

set the menubar of <stack> to {<groupname> | empty}

Description

Use the menubar property to specify which menus appear in the menu bar on Mac OS systems when a stack is the active window.

On Mac OS systems, the menu bar appears at the top of the screen. On Unix and Windows systems, the menu bar appears at the top of the stack window. (LiveCode menus are created with buttons. Each menu is a button whose menuMode property is set to "pulldown" ; these buttons are then grouped to form a menu bar.)

The menubar is the group that contains the buttons used to build the menu bar. This menu bar is used when the stack window is active, replacing the defaultMenubar. If the menubar of a stack is empty, the stack does not have its own custom menu bar, and the defaultMenubar is used when the stack is active.

On Mac OS systems, when a stack's menubar property is set, the stack is scrolled and resized on Mac OS systems so that the group is not visible in the stack window. (On Unix and Windows systems, this is not necessary, since the menu bar is normally displayed in the window.) To scroll the stack window back down so you can see and select the group's objects, set the editMenus property to true.

Examples

set the menubar of this stack to "Menus"

Related

function: stacks, menus

glossary: property, stack window, active window, Windows, menu bar, group, Mac OS, Unix, object

object: stack, button

property: raiseMenus, editMenus, defaultMenubar, menuName

command: group

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

Platforms

desktop

server